IRIX Base Documentation 2002 November/SGI IRIX Base Documentation 2002 November.iso/usr/share/catman/u_man/cat1/pg.z/pg

Text File | 2002-10-03 | 13.1 KB | 331 lines

ppppgggg((((1111))))                                                                    ppppgggg((((1111))))



NNNNAAAAMMMMEEEE
     _pppp_gggg - file perusal filter for CRTs

SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
     _pppp_gggg [ -_n_u_m_b_e_r ] [ _----_pppp _s_t_r_i_n_g ] [ _----_cccc_eeee_ffff_nnnn_rrrr_ssss ] [ _++++_l_i_n_e_n_u_m_b_e_r ] [ _++++_////_p_a_t_t_e_r_n_//// ] [
     _f_i_l_e . . .  ]

DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     The _pppp_gggg command is a filter that allows the examination of _f_i_l_e_s one
     screenful at a time on a CRT.  (If no _f_i_l_e is specified or if it
     encounters the file name _----, _pppp_gggg reads from standard input.)  Each
     screenful is followed by a prompt.  If the user types a carriage return,
     another page is displayed; other possibilities are listed below.  _pppp_gggg
     processes supplementary code set characters in _f_i_l_e_s, and recognizes
     supplementary code set characters in the _s_t_r_i_n_g given to the _----_pppp option
     (see below) according to the locale specified in the _LLLL_CCCC______CCCC_TTTT_YYYY_PPPP_EEEE environment
     variable [see _LLLL_AAAA_NNNN_GGGG on _eeee_nnnn_vvvv_iiii_rrrr_oooo_nnnn(5)].  In regular expressions, pattern
     searches are performed on characters, not bytes, as described on _eeee_dddd(1).

     This command is different from previous paginators in that it allows you
     to back up and review something that has already passed.  The method for
     doing this is explained below.

     To determine terminal attributes, _pppp_gggg scans the _tttt_eeee_rrrr_mmmm_iiii_nnnn_ffff_oooo(4) data base for
     the terminal type specified by the environment variable _TTTT_EEEE_RRRR_MMMM.  If _TTTT_EEEE_RRRR_MMMM is
     not defined, the terminal type _dddd_uuuu_mmmm_bbbb is assumed.

     The command line options are:

     -_n_u_m_b_e_r
          An integer specifying the size (in lines) of the window that _pppp_gggg is
          to use instead of the default.  (On a terminal containing 24 lines,
          the default window size is 23).

     _----_cccc   Home the cursor and clear the screen before displaying each page.
          This option is ignored if _cccc_llll_eeee_aaaa_rrrr______ssss_cccc_rrrr_eeee_eeee_nnnn is not defined for this
          terminal type in the _tttt_eeee_rrrr_mmmm_iiii_nnnn_ffff_oooo(4) data base.

     _----_eeee   Causes _pppp_gggg not to pause at the end of each file.

     _----_ffff   Normally, _pppp_gggg splits lines longer than the screen width at
          characters, but some sequences of characters in the text being
          displayed (for example, escape sequences for underlining) generate
          undesirable results.  The _----_ffff option inhibits _pppp_gggg from splitting
          lines.

     _----_nnnn   Normally, commands must be terminated by a _n_e_w_l_i_n_e character.  This
          option causes an automatic end of command as soon as a command
          letter is entered.






                                                                        PPPPaaaaggggeeee 1111






ppppgggg((((1111))))                                                                    ppppgggg((((1111))))



     _----_pppp _s_t_r_i_n_g
          Causes _pppp_gggg to use _s_t_r_i_n_g as the prompt.  If the prompt string
          contains a _%%%%_dddd, the first occurrence of _%%%%_dddd' in the prompt will be
          replaced by the current page number when the prompt is issued.  The
          default prompt string is ``_::::''.  _s_t_r_i_n_g may contain supplementary
          code set characters.

     _----_rrrr   Restricted mode.  The shell escape is disallowed.  _pppp_gggg will print an
          error message but does not exit.

     _----_ssss   Causes _pppp_gggg to print all messages and prompts in standout mode
          (usually inverse video).

     _++++_l_i_n_e_n_u_m_b_e_r
          Start up at _l_i_n_e_n_u_m_b_e_r.

     _++++_////_p_a_t_t_e_r_n_////
          Start up at the first line containing the regular expression
          pattern.

     The responses that may be typed when _pppp_gggg pauses can be divided into three
     categories: those causing further perusal, those that search, and those
     that modify the perusal environment.

     Commands that cause further perusal normally take a preceding _a_d_d_r_e_s_s, an
     optionally signed number indicating the point from which further text
     should be displayed.  This _a_d_d_r_e_s_s is interpreted in either pages or
     lines depending on the command.  A signed _a_d_d_r_e_s_s specifies a point
     relative to the current page or line, and an unsigned _a_d_d_r_e_s_s specifies
     an address relative to the beginning of the file.  Each command has a
     default address that is used if none is provided.

     The perusal commands and their defaults are as follows:

     (+1)<_n_e_w_l_i_n_e> or <_b_l_a_n_k>
          This causes one page to be displayed.  The address is specified in
          pages.

     (+1) _llll
          With a relative address this causes _pppp_gggg to simulate scrolling the
          screen, forward or backward, the number of lines specified.  With an
          absolute address this command prints a screenful beginning at the
          specified line.

     (+1) _dddd or _^^^^_DDDD
          Simulates scrolling half a screen forward or backward.

     _i_ffff   Skip _i screens of text.

     _i_zzzz   Same as _n_e_w_l_i_n_e except that _i, if present, becomes the new default
          number of lines per screenful.




                                                                        PPPPaaaaggggeeee 2222






ppppgggg((((1111))))                                                                    ppppgggg((((1111))))



     The following perusal commands take no _a_d_d_r_e_s_s.

     _.... or _^^^^_LLLL
          Typing a single period causes the current page of text to be
          redisplayed.

     _$$$$    Displays the last windowful in the file.  Use with caution when the
          input is a pipe.

     The following commands are available for searching for text patterns in
     the text.  The regular expressions described in _eeee_dddd(1) are available.
     They must always be terminated by a _n_e_w_l_i_n_e, even if the -_n option is
     specified.

     _i_////_p_a_t_t_e_r_n_////
          Search forward for the _ith (default _i=1) occurrence of _p_a_t_t_e_r_n.
          Searching begins immediately after the current page and continues to
          the end of the current file, without wrap-around.

     _i_^^^^_p_a_t_t_e_r_n_^^^^
     _i_????_p_a_t_t_e_r_n_????
          Search backwards for the _ith (default _i=1) occurrence of _p_a_t_t_e_r_n.
          Searching begins immediately before the current page and continues
          to the beginning of the current file, without wrap-around.  The ^
          notation is useful for Adds 100 terminals which will not properly
          handle the ?.

     After searching, _pppp_gggg will normally display the line found at the top of
     the screen.  This can be modified by appending _mmmm or _bbbb to the search
     command to leave the line found in the middle or at the bottom of the
     window from now on.  The suffix _tttt can be used to restore the original
     situation.

     The user of _pppp_gggg can modify the environment of perusal with the following
     commands:

     _i_nnnn   Begin perusing the _ith next file in the command line.  The _i is an
          unsigned number, default value is 1.

     _i_pppp   Begin perusing the _ith previous file in the command line.  _i is an
          unsigned number, default is 1.

     _i_wwww   Display another window of text.  If _i is present, set the window
          size to _i.

     _ssss _f_i_l_e_n_a_m_e
          Save the input in the named file.  Only the current file being
          perused is saved.  The white space between the _ssss and _f_i_l_e_n_a_m_e is
          optional.  This command must always be terminated by a _n_e_w_l_i_n_e, even
          if the -_n option is specified.





                                                                        PPPPaaaaggggeeee 3333






ppppgggg((((1111))))                                                                    ppppgggg((((1111))))



     _hhhh    Help by displaying an abbreviated summary of available commands.

     _qqqq or _QQQQ
          Quit _pppp_gggg.

     _!!!!_c_o_m_m_a_n_d
          _C_o_m_m_a_n_d is passed to the shell, whose name is taken from the _SSSS_HHHH_EEEE_LLLL_LLLL
          environment variable.  If this is not available, the default shell
          is used.  This command must always be terminated by a _n_e_w_l_i_n_e, even
          if the -_n option is specified.

     At any time when output is being sent to the terminal, the user can hit
     the quit key (normally CTRL-\) or the interrupt (break) key.  This causes
     _pppp_gggg to stop sending output, and display the prompt.  The user may then
     enter one of the above commands in the normal manner.  Unfortunately,
     some output is lost when this is done, because any characters waiting in
     the terminal's output queue are flushed when the quit signal occurs.

     If the standard output is not a terminal, then _pppp_gggg acts just like _cccc_aaaa_tttt(1),
     except that a header is printed before each file (if there is more than
     one).

EEEEXXXXAAAAMMMMPPPPLLLLEEEE
     The following command line uses _pppp_gggg to read the system news:

          _nnnn_eeee_wwww_ssss _|||| _pppp_gggg _----_pppp _""""_((((_PPPP_aaaa_gggg_eeee _%%%%_dddd_))))_::::_""""





























                                                                        PPPPaaaaggggeeee 4444






ppppgggg((((1111))))                                                                    ppppgggg((((1111))))



FFFFIIIILLLLEEEESSSS
     _////_uuuu_ssss_rrrr_////_ssss_hhhh_aaaa_rrrr_eeee_////_llll_iiii_bbbb_////_tttt_eeee_rrrr_mmmm_iiii_nnnn_ffff_oooo_////_????_////_****
          terminal information database
     _////_tttt_mmmm_pppp_////_pppp_gggg_****
          temporary file when input is from a pipe
     _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_llll_oooo_cccc_aaaa_llll_eeee_////_l_o_c_a_l_e_////_LLLL_CCCC______MMMM_EEEE_SSSS_SSSS_AAAA_GGGG_EEEE_SSSS_////_uuuu_xxxx_cccc_oooo_rrrr_eeee_...._aaaa_bbbb_iiii
          language-specific message file [See _LLLL_AAAA_NNNN_GGGG on _eeee_nnnn_vvvv_iiii_rrrr_oooo_nnnn (5).]
SSSSEEEEEEEE AAAALLLLSSSSOOOO
     _eeee_dddd(1), _gggg_rrrr_eeee_pppp(1), _tttt_eeee_rrrr_mmmm_iiii_nnnn_ffff_oooo(4)
NNNNOOOOTTTTEEEESSSS
     While waiting for terminal input, _pppp_gggg responds to BREAK, DEL, and CTRL-\
     by terminating execution.  Between prompts, however, these signals
     interrupt _pppp_gggg's current task and place the user in prompt mode.  These
     should be used with caution when input is being read from a pipe, since
     an interrupt is likely to terminate the other commands in the pipeline.
     The terminal _////, _^^^^, or _????  may be omitted from the searching commands.
     If terminal tabs are not set every eight positions, undesirable results
     may occur.
     When using _pppp_gggg as a filter with another command that changes the terminal
     I/O options, terminal settings may not be restored correctly.



































                                                                        PPPPaaaaggggeeee 5555